home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / form04a / docs / whatsnew.txt < prev   
Text File  |  1994-03-11  |  11KB  |  327 lines
  1. This file has 3 sections:
  2.     Whatsnew    text description of whats new
  3.     Future      where I intend to go
  4.     History     my comments as I worked on form
  5.  
  6. ========================================================================
  7. WHATSNEW
  8. ========
  9. New options
  10.  
  11. 4.00
  12. -mutate
  13.     displays some mutations in a grid.
  14. -mutate=3
  15.     mutation factor to use to start with.
  16. -layout=2 to 5 
  17.     number of mutations to display at a time (4 to 25)
  18. -VGA16
  19.     uses 16 colour VGA modes 640x480 and 800x600. Useful if you don't
  20.     have enough VIDEO memory, or only a laptop.
  21.  
  22. the -spin flag automatically sets the screen pause off.
  23.  
  24.  
  25.  
  26. 3.00a
  27. New option -gif87 use gif87 format for saving as gif.
  28.  
  29. Version 4.00
  30. ------------
  31.  
  32.     I have added mutations! Try them. They're not exactly complete
  33. but they are interesting. I'm open to suggestions.  See the
  34. mutations.doc for more information. WARNING: don't mutate anything
  35. with a screen_scale factor.
  36.  
  37. I have fixed a terrible bug, stacks of ellipses didn't work in POV
  38. correctly! Thanks go to the two people who reported this to me.
  39.  
  40. Version 3.00
  41. ------------
  42.  
  43. APOLOGY
  44.     I apologise to all of you who've been waiting for this release,
  45.     and expecting it to do much more. I've been trying to do DXF
  46.     format output and getting nowhere fast (or should that be
  47.     slowly). I couldn't even begin to tell you how hard it is to get
  48.     any sensible free documentation of INSERTS and POLYLINES!
  49.     Offers anyone? 
  50.  
  51. GENERAL
  52.     memory fragmentation has been improved, you should be able to
  53.     save a GIF under tighter memory limitiations now.
  54.  
  55.     LEGAL.DOC, I don't know if this is needed, but you never know. 
  56.  
  57. THE LANGUAGE
  58.  
  59. there have been some minor additions to the language
  60.  
  61. CONES       There is now a cone primitive. specifiy base width, height.
  62.  
  63. SPACERS     There is a new invisible object called "spacer", you give
  64.             it a size and it acts as if it were there, but nothing is
  65.             ever output.
  66.  
  67. BRACKETS.   You can often use brackets to "bind" transforms to their
  68.             respective objects. Don't expect too much as this I've not 
  69.             really tested this yet. Tell me if it's not working as you
  70.             expected tho'.
  71.  
  72. SCALE       The version you get may implement SCALE in a different
  73.             way. Sorry, but the old way was not simple enough.
  74.  
  75. COPYRIGHT   A line can now contain the copyright keyword. This line
  76.             will be displayed on the screen.
  77.     
  78. SCREEN OPTIONS
  79.  
  80.     The screen display is now of higher quality.
  81.  
  82. -dos, -ems, -xms, -disk
  83.     It is now possible to use disk space for the ZBUFFER. so you
  84.     don't need any extended memory.(-disk) 
  85.  
  86.     I have implemented a simple conventional memory file cache which
  87.     has helps but it's still pretty slow, you may want to load an
  88.     external cache as well. 
  89.  
  90.     WARNING: no disk space checking is performed!!!! (smacked wrists :-)
  91.  
  92. -skeleton_preview
  93. -skel       Display a preview of the skeleton. This is pre alpha as yet.
  94.  
  95. -aspSave[-|+filename|=filename]
  96.      saves final zbuffer to filename (default "temp.asp"). Format of
  97.      the file is: int x, int y, followed by x*y integers of depth. Depth
  98.      goes from -30000 to +30000. This option was created for playing
  99.      with an autostereo program (aka SIRDS). Tell me if you can find
  100.      a use for this sort of data.
  101.  
  102. -save
  103.     Now saves the FORM script away as a GIF comment. This will thus
  104.     preserve any copyright message, and is in keeping with my policy
  105.     of stashing the script away wherever possible.
  106.  
  107. -res=WidthxHeight
  108.     Selects the next biggest screen mode.
  109.     if you need it you need it!
  110.     I use it for 160x120 MPEG animations
  111.  
  112. -update_ini
  113.     if you use this flag any command line options after it will
  114.     be written back to your sstools.ini file. 
  115.     WARNING this has not been well tested so use with caution
  116.  
  117. POV options 
  118.  
  119. -bounding_boxes-
  120.     You can now turn off bounding boxes to let pov do it's own thing.
  121. POV is usually more efficient a bounding boxes than FORM.
  122.  
  123. -bound_torus
  124.     You can individually turn bounding boxes around toroids on or
  125. off. I don't know if POV adds bounding boxes around toroids, so I put
  126. this in.
  127.  
  128. -pov_declare_all_prims
  129.     To simplify changing the primitives after outputting to POV there
  130. is now an option to declare each unique primitive at the top of the
  131. form file.
  132.  
  133.  
  134. VIVID output (for John Beale)
  135.     This is Primitive but functional. Two options, 
  136.         Option 1 outputs unnested data much like POV, generates HUGE
  137.                 files (especially if you use toroids or ellipses). 
  138.                 CAN have simple textures if you output like this.
  139.         Option 2 outputs nested data. Data is held in (almost
  140.                 randomly) numbered .vo, and included in the original
  141.                 temp.v file. VIVID (or at least the version I'm
  142.                 using) then expands these to a HUGE (again) XYZZY.v
  143.                 file. You'll have to maintain a separate directory
  144.                 for each vivid output generated I'm afraid.
  145.                 CAN'T have textures in this mode!
  146.  
  147.  
  148.  
  149. ===========================================================================
  150.  
  151. FUTURE 
  152. ------
  153. (in no particular order, except the first two)
  154.  
  155.     Bug fixing,     I need to add brackets (these might or might not work)
  156.                     I need to improve error checking
  157.  
  158.  
  159.     MUTATIONS   -   for an explanation see TODD & LATHAM, this is a
  160.                     priority option! 
  161.  
  162.     Improved xms Zbuffer caching (not gonna do this, EMS is good enough)
  163.     add ems Zbuffer caching      (done)
  164.     add disk Zbuffer caching     (done)
  165.     add memory screen images for those that don't have SVGA cards
  166.     (and for text only machines to run overnight)
  167.     
  168.     Perspective. (well why not!)
  169.  
  170.     A graphical interface, very much vapourware at the moment.
  171.  
  172.     different language syntax - I'm not happy with the current
  173.                     language implementation, if anyone has any ideas
  174.                     for a better syntax let me know.
  175.  
  176.     Portability to gnu cc compiler (for the hell of it)
  177.  
  178.     Portability to other platforms (will happen after gnu cc port)
  179.  
  180.     more output formats. (some other raytracers, polyray etc.)
  181.  
  182.     Textures I am particulary open to suggestions regarding implementing
  183.                     textures in POV.
  184.  
  185.     If I can do textures I may add truecolour facilities.
  186.  
  187.     possible new forms ribcage, fern?, and tree?
  188.  
  189.     DXF output, I''m looking into this, and this is the reason this
  190.     release doesn't apear to have much in it!
  191.  
  192.  
  193. ===========================================================================
  194.  
  195. HISTORY 
  196. -------
  197.  
  198. Known Problems : seems to lock up if saving gif to another directory
  199.                  skeleton preview is the pits! (and that's being polite)
  200.  
  201. Untested       : Backets
  202.                  cones in VIVID
  203.  
  204. Lightly tested : SCALE
  205.  
  206. 14/2/94
  207.     What am I doing here on valentines day when my girl is at home!
  208.     fixed inumerable memory overrun bugs.
  209.  
  210. 11/2/94
  211.     added heap checking, loadsd of overruns detected and memory 
  212.     leaks galore. AT least I can now track the little bug***s down.
  213.     Mutations: Wow! I've seen a mutation with my own two eyes!
  214.     The prototype at least proves the idea works.
  215.  
  216.  
  217. 7/2/94
  218.     split the tokeniser from the parser, looking good, 
  219.     mutations look feasible at this stage!
  220.     aspect ratio on the GIFS now set to 0 , XTG v3.0 didn't like an
  221.     aspect of 1!
  222.     added gif87 flag, doesn't save gif comments.
  223.  
  224. 3/2/94
  225.     Defaults are now setup internally in a centralised location, allowing
  226.     me to document them.
  227.  
  228. 1/2/94
  229.     fixed stupid bug when selecting screen mode, the higher the res the worse 
  230.     the mode selected! Glad I didn't release this last night!
  231.  
  232.     Scale now seems to work at last. Phew!
  233.  
  234. 26/1/94
  235.     tidying up for release
  236.     sstools environment variable added
  237.     really does look for sstools.ini on your path
  238.     looks for sstools.ini in the same dir as form.exe
  239.  
  240. 10/1/94
  241.     fixed boxes failing in display=2 mode
  242.     display=1 mode is back, th'o not complete
  243.  
  244. 7/1/94
  245.     added disk cache and disk zbuffer
  246.     added -xms and -disk flags
  247.     added cache_lines variable
  248.     
  249. 4/1/94
  250.     added -skeleton flag, does a bare bones preview.
  251.     input is now saved as a gif comment.
  252.     gif is now 89a to allow comments
  253.  
  254. 20/12/93
  255.     added -res=WidthxHeight, approx 5% slowdown required to allow this!
  256.         looks OK otherwise
  257.     -update_ini to update the FORM section with command line parameters
  258.     note: only updates options specified
  259.  
  260. 13/12/93
  261.     Cones in POV are now correct
  262.     No longer testing POV V1.0 support
  263.     a new flag -pov_declare_all_prims outputs declares even for primitives
  264.     pov output is SLIGHTLY less eager to put object { } around primitives
  265.  
  266. bugs fixed 
  267. 10/12/93
  268.     most command line aguments are case insensitive 
  269.     (like they always should have been)
  270.     cones added for screen output (still need improving)
  271.     -aspsave to save zbuffer to .asp file for later autostereo display
  272.  
  273. 9/12/93
  274.     Tried vivid texturing, seems to work ok. It was a very simple test tho'
  275.     cached data for polygonal representation of primitives now freed after
  276.     use. BIG improvement in memory fragmentation!
  277.  
  278. 8/12/93
  279.     savebackgroundaswhite now works for GIF as well!
  280.     VIVID output now has textures and two options (nested and unnested)
  281.  
  282. 2/12/93
  283.     added vivid output, triangular patches and all
  284.     this should have laid some groundwork for dxf output
  285.     also noticed, if you do sphere, ellipse; end; then
  286.     they are slightly different shades! The sphere is brighter!
  287.  
  288. 30/11/93
  289.     integer rendering speed improved a bit, now only about 5% slower,
  290.     I think it's worth it for the quality improvement.
  291.  
  292. 29/11/93
  293.     integer rendering improved at last, I just can't seem to improve
  294.     it any more! I'm shelving it for a while, since it's a lot better
  295.     than it was. GIT.FRM still screws up at res2 tho.
  296.  
  297. 24/11/93
  298.     bounding_boxes flag added
  299.     bound_torus flag added
  300.     profile error messages actually give the profile flag and value now!
  301.     prototype brackets added
  302.  
  303. 23/11/93
  304.     new object added, spacer - creates a null object
  305.     spheres of -ve radius are not output to POV (since it chokes)
  306.     Copyright now displayed when encountered in a file.
  307.     Updated the docs a bit.
  308.     
  309. 22/11/93
  310.     tried to get the integer stuff displaying at better quality
  311.     dubious success I'm afraid, just can't seem to get it working!
  312.  
  313.     untested: rescale so maxx or maxy is 1, separately from Z depth
  314.     inter frame pause display accounts for time taken for ifp delay,
  315.         making the prediction that much more accurate.
  316.  
  317. 19/11/93
  318.  zbuffer is freed before attempting to save, providing better memory overhead
  319.  the moredata buffer in encoder is checked for NULL!
  320.  the x and y are scaled by 16 before being passed onto scan conversion
  321.     resulting in better float rendering, and with rounding slightly better
  322.     integer rendering
  323.  the bresenham shift factor uped to 13 from 10 giving near perfect float
  324.     rendering
  325.  
  326.  
  327.